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Abstract 



In previous computer-assisted instruction (CAI) development efforts, 
one of the most difficult and trying tasks in program production has been the 
transformation of an author's ideas into machine-usable form. Programmers 
have been required to make decisions about data structures, branching logic, 
and control procedures because authors were not able to anticipate precise 
specifications when the course was being written. Thus, an improved authoring 
language (lAL) to facilitate the transformation of authors' drafts to machine- 
usable form was conceptualized. 

The design of lAL is such that an instructional designer can aid 
the author in giving his course the coherence that will meet programming needs. 
The improved language thus serves as a formal structure that the authoring 
staff can utilize to organize the author's ideas. Providing a "programming 
language" structure, lAL requires data to be specified completely before the 
material reaches the programmer. 

The language is written as a series of commands, many of which could 
be standard routines in the eventual programming language. Each piece of 
courseware data which is manipulated at any one time must be identified 
(labeled) so that it can be referenced. Data may be L0CAL (defined for a given 
oage, template, module, or unit), GL0BAL (defined for a given student), or 
UNIVERSAL (defined for an entire course). Commands are applicable to any type 
of course, but specific parameters or conditions may be unique to a certain 
type of subject matter. Other commands may be defined as need<?d by a given 
course or a given installation. Many parameters are only loosely formatted, 
so that authors can, at times, specify macerial in sentence form. 
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Introduction 

In previous computer-assisted instruction (CAI) development efforts, 
one of the most difficult and trying tasks in the production of CAI programs 
has been the transformation of an author's ideas into machine-usable form. 
Given the available programming languages for a certain computer, the pro- 
gramming staff has usually borne the burden of understanding the author's 
material and ordering that material logically so that the program may be 
written. Unfortunately, teachers do not always prepare course material 
according to progranming logic, and c-e not often aware of the procedures 
and data that must be soecified completely in order for their course to be 
coded. Programtiers have had to make decisions about data structures, branch- 
ing logic, and even control procedures because authors have failed specify 
t'lem when the course was being written. 

On the authoring staff, an instructional designer can be utilized to 
aid the author in giving the kind of coherence to his course that will fill 
progranming needs. In this regard, the improved language serves as a formal 
structure that the authoring staff will utilize to order the author's ideas. 
By giving standard methods in indicating procedures, the language can reduce 
ambiguity in specification. Wi-.h a "programming language" structure, the 
improved language will require data to be specified completely before the 
material reaches the programme;*. 

The authoring staff, then, will write a "pre-program program," and 
so produce material for the programming staff that requires no "debugging" of 
logic or interpretation. This leaves the programmers free to work with their 
unique problems of coding, keypunching, loading, and system considerations. 
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Description 

The language is written as a series of commands, many of which 
could be standard routines in the eventual programming language. Data 
consists of: 

1. Paradigms for control, i.e., student progress, display 
presentation, data manipulation, answer processing. 
Paradigms describe general logic processes, e.g., standard 
Coursewriter branching logic, "Clue" branching logic, how 
to handle a student response of "help." 

2. Routines describing control processes, repeatedly used 
procedures, etc. Routines, unlike paradigms, are specific 
sequences of commands, and when called they are "executed" 
in sequence. Where paradigms are referred to and imply a 
coding sequence, routines are called like subroutines or 
macros and define a coding sequence. 

3. Variables used for scoring, control, etc. 

4. Items in a table, array, or list structure. 

5. Lists of tables, arrays, etc. 

6. Displays, consisting of the text to be displayed and the 
position of the display. 

7. Any author-defined material specific to his course, e.g., 
special considerations and procedures requiring his explar 
ation. 
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Eadi piece of data which is manipulated at any one time must be 
identified (labeled) so that it can be referenced. Manipulation consists 
of: 

1. Displaying. 

2. Erasing. 

3. Inserting. 

4. Moving. * 

5. Altering (adding, subtracting, etc.). 

6. Calling (routines). 

If data is defined at the beginning of a course unit, it retains 
its definition in all subdivisions of that unit, i.e., it is LUCAL to that 
unit as opposed to other units in the course, but it is 6L0BAL for all 
modules within its unit. Data defined for a given module is L0CAL to the 
module, but GLjJBAL to the objectives within the module, etc. Any data 
defined for an entire course is referred to as UNIVERSAL. 

Commands are applicable to any type of course, but specific 
parameters or conditions may be unique to a certain type of subject T.atter. 
Other commands may be defined as needed by a given course or a given 
installation. Parameters are separated by keyword defifliiters, giving g 
natural language appearance. Many parameters, especially conditions, 
are only loosely formatted, so that authors at times will specify material 
in sentence form. This flexibility is necessary to ensure th?! '..ors 
are not restricted in thr power of their design. But some keyword format 
will still be present to limit ambiguity as much 3S possible. 
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Manuscript Conventions 



Standard symbology in command formats: 

1. : : to enclose data identifiers, e.g., 

:V1: refers to a variable 

:A0003: refers to a message 

:CKSW: refers to a routine 

:V1, V2. Al: refers to three variables 

2. [ ] to enclose a literal string when used in a command 

3. { ) to enclose parameters when calling a subroutine 

4. ( ) for subscripting as in 

:TABLE5 (Row, Item): 
:LIST1 (Item): 

e.g.: 

:TABLE5 (3,4): refers to a specific iteir in an array 
or table 

:TABLE5 (3): refers to the third row of the table 
:TABLE5 (,4): refers to the fourth item in each row of 
the table 

:LIST1 (3): refers to the third item in a list 
Standard conventions for constructing displays: 

1. : : to enclose variables in displays 

2. to indicate "reverse shading," e.g., 
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*3. ' > to indicate keyboard response area 
*4. ^ or Ldisplayi to indicate light pen response area 
5. All labels, message identifiers, response identifiers, etc., 
are to be indicated elsewhere than the display guide screen 
grid, i.e., the display grid should not contain anything that 
is not supposed to be actually displayed. 

♦These indicate information that is not to be displayed, but must be 
represented on the display grid. Such information, along with identifiers 
for the responses, numbering for response areas if there are more than one 
at a given time, should be in a color other than the display material (which 
is usually in pencil). 
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Keyword Definitions 



I. 



Structure definition 



1. UNIT 



mark the beginning of each unit. 



M0DULE 



module, objective, and page, and 



0BJECTIVE 



identify them by number, e.g.: 



PAGE 



UNIT 1 



M0DULE 1.1 



gBJECTIVE 1.2.1 



PAGE 1.3.2.4 



2. RESTART ( RST) marks the point where student records are saved. 



1. IF :C1: THEN :A1: 

where :C1: is the author-described condition 



condition is true 

2. G0T0:P1: 

where :P1: is a command in the isequence, or in a unique 
label 

e.g., G0 T0 MgDULE 2.3 

G^ T^ RESPONS E A003IB 
G^ T^ B3#01 



II. 



Branching keywords 



:A1: is the action taken (command sequence) if the 
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Operative keywords (or commands) 

1 . ADD (AD) ... T0 

2. SUBTRACT (SB) ... FR0M 

3. MULTIPLY (MP) ... BY 

4. DIVIDE (DV) ... BY 

5. SET ... T0 [assigns a value to a piece of data] 

e.g., SET :A: T0 1 

SET :B: T0 "The old man" 
SET iTABLEl (3,2): Jl 5 

Comparative keywords 
[all numeric comparisons] 

1 . EQUALS (la) 

2. GREATER THAN (G) 

3. LESS THAN (L) 

4. GREATER THAN gR EQUAL T0 (GE) 

5. LESS THAN gR EQUAL Jl (LE) 

Logical keywords 

1. AND the statement :C1: AND :C2: is true only 

if :C1: and :C2: are both true; may also 
be used to sequence actions, e.g.: 
IF :A: EQUALS :6: 

AND IF :B: GE :C: THEN DISPLAY :M1: 
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2. 0R the statement :C1: 0R :C2: is true only 

if either :C1: is true or :C2: is true, 
but not both , e.g. : 
IF :A: EQUALS :B: 

0R IF :B: EQUALS :C: THEN Gg T0 B3 

3. AND/0R the statement :C1: AND/0R :C2: is true if 

either :C1: is true or :C2: is true or if 
both are true (used as in previous example) 

4. ELSE precedes the alternative for an unsatisfied 

condition, e.g.: 
IF :A: E^ :B: THEN DISPLAY :M1: 
ELSE DISPLAY :M2: AND THEN G0 T0 #01 
G0 T0 #02 

When the I£ condition is true, :M1: is 
displayed, the alternative is ignored, and 
the sequence branches to #02. When the I£ 
condition is not true, :K2: is displayed 
and the sequence branches to #01 . 
There may be a sequence of IF conditions, related by AND, 0R, AND/0R, 
that define a set action pattern. ELSE separates this condition- 
action pattern from the next immediate condition and/or action: 
IF :A: E^ :B: 
AND IF :B: :C: 

0RiF :A: EQ. :D: THEN DISPLAY :M1; 
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VI 



ELSE IF :A: E^ :B: 
0R If :B: Eg :C: 

AND IF :A: Eg :D: THEN G0 T0 #01 
ELSE G0 Jl #02 

:M1: is displayed (1) if A=B and if B=C 

or (2) if A=D 
sequence branches to #01 (1) if A=B and 

if A=D 
or (2) if B=C and 
if A=D 

Evaluative keywords 

1. Keywords used to evaluate syntax 



MATCH 



b. SIMILAR 



c. KEY 



d. INDICATE (IND) 



:A; MATCH :B: is true only if A and B are 
the same character or sequence of characters 
the truth of :A: SIMILAR :B: will depend 
upon similarity criteria specified by the 
author 

indicates a match with a system key, such 

as HELP, etc., e.g.: 

IF : RESPONSE: KEY HELP JHEN ... 

used with light pen responses 

IF INDICATE :P003,1: JHEN ... 

this is a match condition if the student 

indicates an area numbered 1 associated 

with response are labeled P003 



ERIC 



10 



Keywords used to evaluate semantic criteria 

a. EQUIVALENT ( EQV ) :A: EQV :B: is true only if A implies B 

* and B Implies A. For example: 
beagle implies dog , 
but doa does not imply beagle , 
so dog and beagle are not equivalent. 
Implication may be described by: 
if A then B 

Equivalence may be described by: 
if A then B and if B then A 
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IMPROVED LANGUAGE COMMANDS 



(Keywords are capital letters underlined.) 



REC0RD 



[for storing archival data--specified at 
the beginning of a unit, module, page, 
or template] 



Form: 



2. 



DEFINE 



REC0RD :N1: AT :W1: 
where 

:N1: specifies data to be stored 

(test scores, variables, responses, 
etc.; or the identifier of a list) 

:W1: specifies when the records are 
to be recorded 

(restart points, response point, etc.) 

[identifies data specified at the begin- 
ning of a unit, module, page, or template; 
data defined is "local" to thac unit, 
module, page, or template] 



Form: 



DEFINE :W1: 



where 



:W1: is VARIABLES 

e.g., author (NWA— number of wrong 
answers 

(NTl— number of trials 
specifies (etc. 

LISTS 

(e.g. , a list of tables or 
display identifiers) 

TABLES 

(e.g., arrays, matrices) 
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DICTIgNARIES & GRAPHICS 
DISPLAYS 

(e.g. , display guides) 
PARADIGMS 

(e.g., logical processes) 
R0UTINES 

(e.g., subroutines) 
SPECIAL 

(any original author-defined 
material, e.g., special considera- 
tions or conditions, repeatedly 
used instructions, etc.) 

[specifies dynamic data to be saved; 
specified at the beginning of a unit, 
module, page, or template] 



SAVE :N1: IF :W1: 



where 

:N1: is the identifier of the data 
to be saved 

:W1: is the condition for saving the 
data (usually written semanti- 
cally— see Keyword Definitions) 

[specifies parameters for locating an item 
in a list where all the items in the list 
are values for a single variable] 

SELECT :V1: FR0M :L1: STARTING :N1: 



T0 :N2: INCREMENT :N3: UNIQUE 
where 

:V1: identifies the variable for which 
the value is being selected 
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:L1: identifies the list or table 
used (may be written TABLE:L1: 
or LIST:L1: , etc.) 

:N1: is the starting field (may 
be omitted; Default: first 
field) 

:N2: is the ending field (may be 
omitted; Default: final field) 

:N3: is the increment: 

;--sequentially through the list 

2- -every other item is selected, 

beginning with the first 

3- -every third item is selected, 

etc. 

(may be negative to reverse the order of 
selection of keywords: 

RAND0M--items are selected from the 
list at random 

:R1: --the identifier of an author- 
defined routine for selecting 
i tems 

(may be omitted; Default: 1) 

UNIQUE--if included, no item from the 
list will be selected twice 

[specified parameters for selecting lines 
from a table where the items in the line 
are values for more than one variable] 



SELECT :V1, V2, etc.: FR0M :L1: STARTING :N1 

T0:N2: INCREMENT :N3: UNIQUE 

where 

:V1, V2, etc.: identify the variables 
for which the values are being selected 

:L1: as in 4 
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:N1: is the starting line 
:N2: is the ending line 
:N3: is the increment 



as in 4 



UNIQUE— if included, no line from 
the table will be selected 
twi ce 

[generates random numbers for a variable] 



GENERATE :V1, V2, etc.: BETWEEN :N1: AND 

:N2: UNIQUE 

where 

:V1, V2, etc.: identifies the variable(s) 
for which values are being generated 

:N1: is the lower limit 

:N2: is the upper limit 

UNIQUE— if included, none of the varia- 
bles will receive the same 
random value as any other in 
the command 

[indicates that text is to be displayed on 
the screen] 

DISPLAY :M1: STARTING LINE :N1: i:Wl:i 
where 

:M1: — 

(a) is a predefined message 
identifier 

(b) is a variable identifier 

(c) is a written message 
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:N1: specifies the starting line of 
the display. If the message is 
already defined with positioning 
parameters, :N1: will override 

(may be omitted. Default: if no 
positioning parameters are inherent 
to the message, the message is displayed 
starting with the first line available 
on the screen at the time the command 
is made. If sufficient space is 
unavailable, no message is displayed 
and the author shall be informed at the 
programmer's discretion, or, if space 
is available, the message ":M1: too 
large" will be programmed.) 

:W1: is a special consideration in 
displaying the line, e.g., 

CENTER ) may be defined 

) semantical ly 
SPELL-0UT ) 

RIGHT T0 LEFT ) by the author (see 2) 

(may be an identifier for an author- 
defined routine describing the method 
of display) 

[specifies an area of the screen to be 
erased] 



ERASE :M1: 
where 

:M1: - 

(a) identifies a message previously 
displayed to be erased from the 
screen as it was most previously 
displayed 

(b) is :N1:, :N2: when 

:N1: is the first line to be 
erased 

:N2: is the last line to be 
erased and all lines 
between are to be erased 
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P0SITI0N SLIDE :N1; 
SHgW SLIDE :N1: 
REM0VE SLIDE :N1: 



P0SITI0N AUDI0 :N1 
PLAY AUDI0 :N1: 



RESP0NSE 



[positions slide and opens shutter] 

[closes the shutter; must be included if 
new slide is to be positioned with shutter 
closed] 



where 



:N1: identifies a frame on the slide 
projector 



[positions and plays] 
where 

:N1: identifies the audio message to 
be played 

[indicates that a student response is to 
be accepted] 



Form: 



EVALUATE RESP0NSE 



RESP0NSE :L1: :W1: 



where 



:L1: is an EP identifier; refers to 
a display guide on which the area 
for the student response is indi- 
cated by a box with the EPID 
associated 

:W1: indicates the method of response: 

KEYB0ARD 

PEN 

(may be omitted. Default: KEYB0ARD) 

[precedes a description of evaluation action 
and criteria for action; may be a routine 
defined in 2] 
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IF :C1: 

0R IF :C2: THEN :A1: 

JUDGE :W1: 

ELSE IF :C3: 

AND IF :C4: 

0R IF :C5: THEN :A2: 

JUDGE :W2: 

where 

:A1: 

:A2: denote actions to be taken, e.g., 

DISPLAY :M1: 

CALL :R1: 

:C1: 

:C2: 

:C3: 

:C4: are conditions written semantical ly 
by the author 
(see Keyword Definitions ) 

:W1: is either C0RRECT, INC0RRECT, or 
UNANTICIPATED (may be written CA, 
WA, UN, AA (no judgment), or 
simply as an identifier, e.g., 

CI 

CAl, etc.) 
(may be omitted) 
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CALL [indicates that a routine is to be performed] 

CALL :R1: {:P1. P2. P3:} 
where 

:R1: identifies the routine to be 
performed 

:P1, P2, P3: are parameters to the 
routine 

(may be omitted; if specified the 
routine must have a list with the 
same number of items referring to 
data in the routine) 

When a routine is called, the coding sequence branches to the 

beginning of the routine and proceeds until the end of the routine 

is reached. The coding sequence then branches to the statement 

iironediately following the CALL command and proceeds. Units, modules, 

objectives, and pages may all be called as routines. 

CONTINUE [indicates that course execution is 
interrupted until the student presses the 

C0NTINUE key, space bar, etc., depending 

on the hardware available] 

REFER [indicates that a paradigm will describe 
the logical flow of a coding sequence] 

Form: REFER :R1: 

where 

:R1: identifies the paradigm 
The placement of the REFER command determines the coding sequence it 
will govern-. If the command immediately follows a UNIT, M0DULE, 
OBJECTIVE, PAGE, or routine identifier, then the paradigm will demon- 
strate the logical structure of the unit, module, etc. If the REFER 
command follows an EVALUATIVE command, then the paradigm will govern 
the answer-processing logic. 



